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ABSTRACT 

Symbolic Interactive Matrix Processing Language 
(SIMPLE) .is a conversational matrix-oriented source language suited 
to a batch or a time-sharing environment. The two modes of operation 
of SIMPLE are conversational mode and programing mode. This program 
uses a TAURUS time-sharing system and cathode ray terminals or 
teletypes. SIMPLE performs all the standard operations on matrices, 
and eigenvalues, eigenvectors, remote plotting, and inquiry commands 
are also available. Self-paced instruction through TEACH commands 
allows the student to proceed at his own pace while maintaining full 
documentation. This paper is an introduction for the novice and a 
reference guide for the casual user. The SIMPLE Reference Manual 
provides a more rigorous definition for the experienced user. (CH) 
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PREFACE 



SIMPLE (Symbolic Interactive Matrix Processing LanguagE) is a conver- 
sational matrix oriented source language well suited to either a batch or a 
time-sharing environment. 

This document is not intended to be an instructional text nor a pro- 
gramner's reference manual, but rather an introduction for the novice and 
a quick reference guide for the casual user. It does not attempt to tell 
the whole story and in some instances overstates constraints for the sake of 
simplicity, and clarity. 

Chapter 0 would normally be appendix A in most texts, but has been 
included initially in the hope of capturing the reader's interest and 
demonstrating SIMPLE' s versatility. 

The description of SIMPLE presented herein is basically non- technical 
and an informal approach is taken in hopes of enhancing initial comprehension, 
A forthcoming edition (SIMPLE - a Reference Manual) will provide a more 
rigorous definition for the experienced user. And SIMPLE - an Applications 
Manual will demonstrate the use of SIMPLE over a wide range of applications. 

The author would like to express his gratitude for support received 
from the Department of Civil Engineering and NSF Grant GY-9340, project 
Computer Based Education (C-BE) of the National Science Foundation. 
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0.0 Example 



TRIJPIJS - 18 SEP 74 10. 17. 07 
^ =C ERB 1 as - NRNCY RBC 
JDENRME: CERBiaS-SCi 

CHRPGES YERP-TD-riRTE : TIME -143 . 48 SUPPL I Ei 1.7 . , 

CCi 

EKECPF 0 ERilEP 
SDi 

END - ERSIEP 
;CC! 

T'SIMPLE 

' FILE RLRERDV RSSIGNED. 
: END - DFN 

: 17 SEP 74 I H TPDDUCTDRY MhMURL HDW RVRLhBLE 
i in SEP 74 ♦♦♦♦ SIMPLE VEPSIDM 3.4 PUT DN LIME 
i 15 JUL 74 LRTEST UPDRTE TD TERCH DP PDDP 

HELLDj this is simple (3. 4:' 
TYPE HELP' FDP MORE INFDPMRTIDN 
THE TINE IS IS SEP 74 li:i.l7.4d. 
7 -t 0. 1 THE crlculhtdp ndue ♦♦♦♦ 



? 4 ♦RT Na- 
si. 14159265 35998 

355- 113 

3. 14 1592880 354 0 

- 3. 14835 71488571 

7 EVpa> 



t THIS IS PI 

I THii IS CLOSE 

I BUT THIS MILL BD 

i, iiiJULli YDU BELIEVE "E" 




8.71388188845 9 0 
■■ 1 0.8 SOME CDMNRr-lDS 
•■ TIME 

THE TIME IS IS SEP 74 10.80.45. 
';■ LORD R 8 8 

LETS LDRD R ■ PDi..l-'.H SE :• 

-. pDu::, 8 CDLUNhS - HDU MhNY VhLUES PEP LINE 

"- 4 

□K, 4 PEP LINF IT IS 

- 13 8 0 5 3 

RLLPIGHT^ UE HRVE LDhDED ri 
7- TERCH LDU 

LDM<E:> - DECDNPDSITIDN FUNCTIDN' LjD.RND U RPE 
rONPUTED SUCH THRT L*ri*U=Ej 
L I": R UNIT LDUEP TPIRHbULRP MRTPIK 
U IS R UNIT UPPER TRIRNGULRP MRTRIX 
D IS R DIRGDNRL MRTRIX 

? TERCH DIVIDE 

DIVIDE,R, <L>, <D>, <U.> - R IS SUBDIVIDED INTO L, D, 
RND U ': R=L+D+U ' ' 

L r-DNTRINx THE SUEDIRGDNRL ELEMENTij 
D THE DIRinDNRL, RND U THE SUPERD I RbDNRL ELEMENT i: 
7- DC = LDUc.R> :f DECDNPDSE R RND :TDRE IN DC 

0-1 



TERCH IDEHT 



IDEhT'fljN - FIN N BY H IHENTITY NRTRIX^R^ H 
CRERTED 

? I DENT I ^ 



? rHVIDE DC LjDjLI 
':L+I > ♦D* I+U-i 



? LET'S CHECK 



SCRLED BV 
1 

1 1.30 
c* . -• ij 

? IR 



lE+Cil 

c 

2 . 0 0 
. 3 0 



•i; H INVERSE 



■i; DETERMINEHT DF R 



SCRLED Et lE+mO 
1 £ 

1 a. ijij -5. 0 0 

£ -l.£5 3. £5 

? DETCR.' 

4 

7 TERCH CONST 

rONxT.RaHR.NCC - RN MR BY NC MRTRIX.H-IS CRERTED 
. CUn^T^fuO " = ^ """^r CREATE X . «LL OHES 

? i LETS PPDDUCE R TRBLE DF RRNDDM NUMBERS _ BETWEEN U RND 10 



= RND ( 1 u*;>-; 



■I in^RNDCX;-' IS EQUIVILEHT 

•t DISPLRY THE TRBLE 



SCRLED BY lE+00 

1 £ 3 4 

1 l.£0 f..04 6.3£ 6.4 0 

^ .45 3.67 4.44 7.31 

3 6.97 3.87 4. £3 5.14 

:;.75 8.99 



4 £.£7 4.6 9 ' 

? SUM ' •■ 16 

= 5 . t. 7 3 3 4 3 9 3 0 6 5 £ £ 
? TIME 

THE TIME IS 13 SEP 74 10. £3. £3. 

7 I fi.-; THE PRDGRRMMING MODE 

7 U SQR = . 5* SQR + K-- SQR 

7 £: 1 = 1 + 1 

■73: I & SQR • 

7 = R 

7 SQR = R 

-• RUN 3 TIMES 
MRTRICES INCDMPRTIBLE 1 OS li>-.'3 
ERRDR IN LINE £.0000 RETURNING CDNTRDL TD U-ER 

7 ' ■ I = 0 t I FDR6DT TD INITIRLIZE I 



■B CHECK THE RVERRbE 
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-• RESUME i. THI S WILL RE FURH CDriTPDL TD THE PPDbRRM 

= " 1 

SCALE D BY lE+01 
1 £ 

1 .70 1.00 

2 .25 .45 

SCRLED BY lE+00 

1 2 
1 4.15 5.77 
£ 1.44 2.71 

3 

SCRLED BY lE+00 
1 2 

1 3.17 4.26 

2 1 . 06 £.10 
? DIGITS 9 

? RUN 3 MURE 

4 

SCRLED BY lE+00 

1 £ 
1 3 . 0 045 33 07 4 . 0 0 7 096 04 
a 1. 00177151 2.0 0276656 
5 

SCRLED BY lE+00 

1 £ 
1 3 . 0 0 0 0 0363 4.00 0 0 0566 
a 1 . 0 0 0 0 0142 £ . 0 0 0 0 0££ 1 
6 

SCRLED BY lE+00 

1 £ 
1 3 . 0 0 0 0 0 0 0 0 4. 0 0 0 0 0 0 0 0 
£ 1 . 0 0 0 0 0 0 0 0 £ . 0 0 0 0 0 0 0 0 
? R - SQR ♦SQR 



•t LETS CK DUR RESULT 



•t. MOT BRD 



SCRLED BY IE- 10 

1 £ 

1 1.4£0517 04 -4.5110937£ 

2 .55479177 -1.76 044 068 

■-■ KILL RLL i DELETE THE CURRENT PRDGRRM 

■7 J LETS DD THAT RGRIN WITH R LITTLE DIFFERENT RPPRDRCH _ 

T' 10: IF I<=LIMIT THEN 1 = 1 + 1 ^ SQR= . 5* .:.SQR+K--SQR > t GD TD 1 ■ J 

? £0: "ITERRTIDNS" 'i-. I 2< "SQR DF X" Z< SUR 

? LIMIT = 5 J ^ ^ , ^ ... j; IHITIRLIZE 

I nnnri- ^QR = X INITIRLIZE 

itioOOz IF I<=LIMIT THEN ^=1-^1 ^ SQR=. 5* CSQR+X.SQR:. GD TD 10 

^n.OOOO: "ITERRTIDNS" ^ I & "SQR DF X" t: SQR 



RUN 



VRRRBLE UNDEFINED □ 

ERROR IN LINE 5. ijCnjO RETURNING CDNTPDL TD USER 
7 5: 1=0 & SQR = K t INITIRLIZE 

••• '£ THRTS R 0<ZERD> NOT RN □<DH:' 
•T- RESUME 

ITERRTIDNS 

= 6 

SQR DF X 



SCRLED BY lE+00 

1 2 

1 3 . U 0 0 0 0 0 0 0 4 . 0 0 0 0 0 0 U 0 

2 1 . 0 0 0 0 0 0 0 0 £ . 0 U 0 U 0 0 0 0 



LIST 
NRNE 

n 

DC 

L 

D 

U 



ROW:: 



•3 



COLUMN:: 
2 



LIMIT 1 1 

I 1 1 

S'UR 2 2 

MR>=: OF 137 I..IDRDS USED OUT OF R POSSIBLE 229 LERVINb 



? TIME 

THE TIME IS 
■'' STOP 



18 SEP 74 10.41.47. 



';.OCTRL;' 
'•DECIMRL • 



REQUESTED USED 
FIELD LENGTH OfiOOOO 047644 

NRTRIX STORRGE 229 137 

CC: 

TPPINT 
GO: 

♦ ♦ 1 COPIES OF OUT RELERSED TO THE '•TH" PRINTER 
CC: 
jQLO 

RCCOUNT-RUN LN-MIN LN-COST TM-SEC TM-CO:iT 
CERB 1 23-2 0 24 % 0 .16 17. 67 0 1 1 . 27 




0-4 



1.0 Introduction 

SIMPLE is a conversational interpretive system for performing a multi- 
tude of matrix operations. Its use is made possible by the TAURUS time- 
sharing system through the use of a remote CRT (Cathode-Ray terminal) or 

TTY (teletype) . It is an easy-to-use tool even for beginners who have 

no experience with computers or a programming language, and only a minimal 
introduction to matrix calculations. 

SIMPLE is an effective mechanism to introduce students in formal classes 
and others to time-sharing capabilities. Concepts involving matrix algebra 
are reinforced by the ability to get quick results through direct interaction 
with the computer. Self-paced instruction through SIMPLE' s TEACH commands is 
a unique and rewarding feature allowing the student to proceed at his own 
rate, while insuring that the necessary documentation is always available 
and up-to-date. 

SIMPLE performs all the standard operations on matrices along with a 
few not- so-standard operations. General matrix algebraic expressions are 
acceptable including parentheticals --- providing the user with generality 
and simplicity heretofore unattainable. Such things as eigenvalues and eigen- 
vectors, remote plotting, and a group of inquiry commands are also available 
for the more mature user. 

For clarity, we will describe SIMPLE assuming we are in an interactive 
environment, but SIMPLE can also be used via batch operation. There are two 
modes of operation: the conversational mode and the programming mode. When 
idling (waiting for your next request) , SIMPLE is ready to receive one of 
three types of request: 

1) a Command 

2) an Algebraic statement (an equation or an expression) 

3) an Edit (Programming Mode) 

types 1) and 2) are conversational (i.e., action is requested immediately), 
while 3) is a programming mode request (the editing action is requested 
immediately but the statement will not be executed until later). 



ERIC 



1-1 



2.0 Fundamental Elements 

Every statement in SIMPLE is composed of some combination of 3 inde- 
pendent parts. 

<#>: <S>$< comment > 

These 3 parts (the statement number, the primary syntax, and the connnenting 
field) are separated by SIMPLE 's 2 primary delimiters. 

2. 1 Delimiters 

The : separates the statement number from the rest of the statement and 
identifies it as a Programming Mode statement. 

The $ identifies the end of the primary syntax; what f tllovj-s is free- 
field commentary for documentation purposes. 

The Sc has 2 purposes. It allows us to stack expressions in the Expression 
form of the Algebraic class and simplifies outputting (e. g. , A & B & A+ B) . 
In a similar capacity, in the Programming Mode & allows us to stack primary 
syntax within the same line (e,g, , 1: 1 = 1+1 & 00 TB I) . 

The © is not a character but is used to stand for the general separator 
and represents a character or group of characters as defined below. © may be 
a comma (,), any number of blanks (^1) , or a comma preceded or followed by 
any number of blanks. 

The " always occurs in pairs and is used to enclose an alphanumeric 

string (see 3.3). 



2. 2 Constants 

A numeric constant may be a signed 
up to 10 significant digits. Constants 
notation by using "En" which stands for 



numeral in integer or real form with 

may be expressed in scientific 

"X 10^" (e.g., 1.3E5 means 1.3x 10^). 
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2.3 Variables 

Variables in SIMPLE start with an alphabetic character and may be 
followed with up to 9 additional alphanumeric characters. A variable may be 
either a scalar or an array. Arrays may have one (a column vector) or two 
dimensions (a matrix). 

2-1 



A subscripted variable (<var> [<e>] or <var> [<el>, <e2>]) 
is a special case of a scalar variable and is legal anywhere a 
variable is allowed, e.g., A[I] = 3*B [x , I* ( J-l-2) ] . See Appendix C 
No. 2,7. 
2.4 Relation s 

Relations may or may not be functions. In SIMPLE there are 3 basic 
relational symbols: 

< > = 

These respectively mean less than, greater than, and equal. Any paired 
combination of these 3 is allowed, and "or" is the implied connector 
(e.g. , < = means < or =, = < means = or <, >< means > or < (i.e. , not equal)). 
These may be used with relational expressions in a SIMPLE IF-THEN statement 
(see 5.4). 

Functions may be either operators or non-operators (hereafter referred 
to as intrinsic functions). 
Arithmetic Operators 

Since variables in SIMPLE may be scalars or arrays their complete 
definition is slightly more involved than normal (for the complete definition 
use TEACH (see 4.0)). It should be stated, while some are primarily scalar 
operators (t) and some are primarily array operators (',[]), no matter 
what the variable type, the operation is well-defined (assuming compatability) . 
See appendix C, No, 1, 10, 11. The hierarchy of operations is as follows: 

(!)[]- subscript evaluation 

(2) ( ) - innermost parentheses next 

(3) ' - transposition 

(4) - multiplication, division, and exponentiation 

(5) 4.^- . addition and subtraction (including negation) 

(6) = - assignment 

Intrinsic Functions 

As was the case with SIMPLE operators, some functions are primarily 
scalar oriented and some array oriented, but all are well-defined. 

All intrinsic functions have a 3 character name combined with a parenthesis 
pair enclosing any legal SIMPLE expression. A list is on page iii (use TEACH 
for more information). See Appendix C, No. 7. 



2.5 Expressions 

Expressions in SIMPLE are somewhat analogous to algebraic expressions 
in mathematics, and are defined as follows. A constant, variable, or 
function is an expression. Furthermore, if x and y are expressions, 
then so are: 

(x) -X x^y x*y x/y x + y x-y x' 

Examples ; 

3.1 X A[N] 3^ x + 3*(A-SIN(x)) 

SQR( (x[ll - x[2]) f 2 -I- (y[ll - y[2]) f 2 ) 

Expressions are evaluated according to the higharchy of operations (2.4) 
When equal, they are processed from left to right. 
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4.0 The Command Class 

The command class is second only to the calculator mode in simplicity. 



< command >< parameter list> 
or more specifically, 

< command > ® P © © * * * 

where ® is our generalized separater (2.1) and p^ represents a SIMPLE 
constant or variable (n may be o , i.e., no parameter list). 

The command class is composed of three groups. The most basic (HELP • . - 
CLEAR, see iii) are either informative (HELP, POOP, and TEACH) or general 
purpose (LIST, CLEAR, STBP, TIME, EJECT), Of these only TEACH has a parameter 

list. 

TEACH © P 

TEACH may be the most important command, for with it, the user may 
obtain information about all SIMPLE commands, functions (including operators), 
and programming syntax. Because of this, the user is referred to the list of 
commands on page iii, and instructed to use TEACH for more information. Note, 
TEACH with no parameters will TEACH everything. 

The second group of conmands (C^, see iii) give the user the ability to 
manipulate program files (READ, SAVE, SHOW), edit files (KILL), and execute 

files (RUN, RESUME). . 

The third group contains a powerful assortment of matrix manipulation and 
numerical related commands (LOAD, DELETE, • • SSRT, • • EIGEN) . 
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3.0 The Algebraic Class 

The algebraic class of statements gives us the ability to manipulate 
variables in a mathematical sense and evaluate equations of the form (v = e) , 
and multiple expressions of the form e^ & e^ & * * ' • 

3.1 Equations (v = e) 

V is either a regular or subscripted variable and e is a legal SIMPLE 
expression. A very general form of an equation is allowed. It may be a 
matrix equation, a scalar equation, or a combination as long as compatability 
requirements are met. 

3.2 The "Calculator" Mode (e^^) 

This can be thought of as a sepcial case of v = e, where we substitute 
"TTY" for V . In other words, after e is evaluated it is merely outputted 
(written to the output file if batch, displayed if interacting) as opposed to 
being stored in v . This is really just the degenerate form of the SIMPLE 
output mechanism below. 

3.3 eutput (The "Expression" Mode e^^ & eg & ' ' * ) 

As described in 2.1 the delimiter & serves to separate expressions 
and alphanumeric strings ("• • •") to be output. 
Example: "A" & A & "B" & B & "A*B" & A*B 
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5.0 The Programming Mode" (<#>;< s >) 

This mode provides the user with the most powerful aspects of SIMPLE. 
It Is through the programming mode that an Internal program Is created and/or 
modified. In connection with the program manipulation commands. It may be 
retrlved, saved, displayed, deleted, or executed. 

A statement in SIMPLE is of the programming mode if and only if it has a 
statement number followed by a colon (:). The syntax <s> which follows may 
be from the Algebraic class, the Command class (excluding , see page ill), 
or the program Control Syntax (PCS, see 5.3). Statements may be compounded 
using the & . 

Example: 1.3: I = 1 & x = SIN(P) & 00 Te 21 

A SIMPLE internal program is executed by processing the statements in 
ascending order (unless diverted by a GG T9 or a De PART) until the end is 
reached or a PAUSE is encountered. See i^pendix C, Nd. 5. 

5.1 Statement Numbers 

Every statement number has one of the following forms: 
a.b .b a. or a where, 

1^3^:9999 and 0001 ^b^ 9999 
(i.e., 0 < # < 10000 and has at most 4 significant digits to the left or 
the right of the decimal point). 
Examples: 1017.0302 .02 17. 100 

5.2 Editing 

Editing in SIMPLE is very straightforward. To insert a statement 
between statement a and c (c > a) , simply preface the new statement with 
b , where a<b<c . To replace statement number b , just preface the new 
statement with b . 
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5.3 Syntax 

All program control syntactical entities (00, 10, IF, THEN, D0, 
PART, F0R, = , TO, BY, PAUSE) must be separated by blanks (a space). 

PAUSE PAUSE < string > 

When a PAUSE is encountered, control is returned to the user and < string > 
is output. (i*e., the RUN command iniates the execution of the internal 
program, and PAUSE terminates it (possible temporarily). 

SIMPLE will automatically produce a PAUSE if a syntax or an execution error 
is encountered. The RESUME command enables the user to resume execution 
after the PAUSE* 



G0 T0 GO TO < e > 

When a Ce T0 is encountered <e> is evaluated and control transferred to 
the smallest statement number that is greater than or equal to <e> . 

IF-THEN IF <e^> <^> < eg > THEN <S > 

^ represents some combination of relationals (2.4). The expressions 
< ej^> and <e2> are computed and then the relational expression 
<ej^><^><e2> is evaluated (either true or false). If true, <S> is 
processed. If false execution resumes with the next line. 

D0 PART D0 PART N ' F0R B = C TO D BY E 

D0 PART is basically a subroutine call although it can be used in much 
the same manner as a F0RTRAN DB L00P, B must be a variable (non- subscripted) , 
while N , C , D , and E may be either constants, variables (regular or 
subscripted), or packed expressions (no embedded blanks). N is evaluated 
and truncated and then control is transferred to the group of statements that 
lie between N and N + 1 (including N) . (e.g., D0 PART 4 would execute the 
group of statements with statement numbers from 4 to 4.9999). 

Parameters may be deleted from the right giving us a total of 4 possible 
forms (use TEACH D0) . See i^pendix C, No. 4. 



6.0 Using SIMPLE on TAURUS 



J\ stands for 
"CTRL" G 
(the bell) 



type "CTRL" G 



No 





No 



type "CTRL" C 



SEQUENCE CARD 
PASSWORD CARD 
J0BCARD 

EXECPF , 2450 , S IMPLE (I , 0) 

<E0R> 
-TEXT- 
<E0F> 



il,LeGIN=CE /X/..- 

EXECPF 2450 EASIER 



Yes 



Create or Fetch 
< code > 








SIMPLE I=<code> 







PRINT 



No (interactive) 

1 




<A,L0 




Enter SIMPLE 



Exit SIMPLE 



clear screen 
and disconnect 
phone 
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The most general form of the SIMPLE control card macro is: 

SIMPLE I=<fn> 9=<fn> C=<fn> P=<fn> Tl=<fn> T2=<fn> FL=<#> 

where I declares the input file, default = TTY 
e declares the output file, default = BIjT 
C declares the input copy file, default = IN 
P declares the program copy file, default = PR0G 
Tl declares the 1st data copy file, default = Tl 
T2 declares the 2nd data copy file, default = T2 
FL declares the field length limit, default = 53000 

SIMPLE I e is equivalent to SIMPLE I = INPUT e=eUTPUT which says that this 
is a standard batch run. 

SIMPLE I = < fnl > 0 = < fn2 > • • • 

is the form the user may use to batch a job from a remote terminal. 




6-2 



APPENDIX A 
SIMPLE Character Set 



the English alphabet 
the base ten digits 
the relational symbols 
the arithmetic operators 
the non- arithmetic operators 
the delimiters 



A B • • • Z 

0 1 2 3 • • • 

= > < 

+ - * / t ' 

- ( ) [ 1 



APPENDIX B 
Accessing TAURUS 



The following assume the terminal is acoustically coupled. If the 
terminal is hardwired the user need only L0GIN. 



A> Teletype 

1) turn on-line 

2) turn on 

3) push TALK 

4) dial the niomber 

5) push DATA 

6) hang up phone 



B. Pat apoint /Mini-T .E.G. 

1) turn coupler on 

2) put on remote 

3) turn on 

4) dial the number 

5) place phone in coupler 



As of 1 September 1974 the number is 9-474-5011. 
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APPENDIX C 
Notes 



1) Parentheticals may be nested up to 9 deep. 

2) Subscripts may not contain subscripted variables. 

3) Variables and constants have at most 10 characters. 

4) You cannot depart (D0 - PART) to a depth >8. 

5) The maximum number of statements in an internal program is 30. 

6) DELETE and CLEAR relate only to variable storage while, KILL <#> 
and KILL ALL relate to the internal program buffer. 

7) Embedded blanks are not permitted between a function name and its 
parenthesis pair, nor between a variable and its subscript. 

8) All intrinsic functions have 1 parameter and a 3 letter mnemonic. 

9) All commands have 4 or more letters. 

10) Beware: the hierarchy of ^ is identical to * and / . 

afbfc = (atb)l^c , a*bfc = (a*b)^c 4 a*(bfc) 

11) Beware: the hierarchy of -(negation) is the same as -(minus) 

consequently, -afn ^ (-a)f n when n is an even integer 
(e.g. .3t2 = -9 = -(3 4^2) ^ (-3)f2 = 9) 



C-1 



ERiC 



